home *** CD-ROM | disk | FTP | other *** search
/ Nautilus 1993 August / Nautilus CD Magazine Volume 3-8 August 1993 Windows Edition.mdf / games / rse / ti21.exe / TRASHIT.DOC < prev    next >
Text File  |  1992-11-30  |  17KB  |  335 lines

  1.  
  2.                 * * * * * * * * * * * * * * * *
  3.                 *  Trash-It (tm) Version 2.0  *
  4.                 *   Copyright 1992 RSE Inc    *
  5.                 *        Oct 17, 1992         *
  6.                 * * * * * * * * * * * * * * * *
  7.  
  8. Have you ever accidentally deleted a file or groups of files and 
  9. found you couldn't recover them?  I have.  Several times.  Now 
  10. there's a way to prevent this from ever happening again. 
  11.     
  12. Trash-It works with DOS, PC-Directory, PC-FileNotes, MS Windows or 
  13. any program that uses DOS function calls to delete files.  Instead of 
  14. deleting the file, Trash-It moves the file over to the \TRASH subdir.  
  15. In other words, your deleted files remain intact, they just get moved 
  16. out of the way.  If you accidentally delete a file, don't worry, it's 
  17. still completely intact over in the \TRASH subdir where DOS can't 
  18. overwrite it.  And Trash-It is completely transparent to the user. 
  19.  
  20. But you say, "I have an un-delete program".  That's all well and 
  21. good, however, if DOS has overwritten any part of the disk where the 
  22. deleted file was stored, even the most sophisticated of the un-delete 
  23. programs fail.  The less sophisticated ones fail for even more 
  24. reasons (directory info overwritten, files clusters that aren't 
  25. contiguous, etc..).  In my experience un-delete programs work about 
  26. half the time, if you're lucky.  With Trash-It there's no chance of 
  27. DOS overwriting the file, because the file is never deleted. 
  28.  
  29. Of course, since you're not actually deleting these files, eventually 
  30. your hard disk is going to fill up, requiring that you "dump the 
  31. trash", i.e. go to the \TRASH subdirectory and clean it out.
  32.  
  33. When you register you'll get AutoDump, a program that automatically 
  34. deletes trashed files (files that have been moved to the TRASH 
  35. subdir) that have been there longer than the number of days you 
  36. specify.  In addition, AutoDump gives you the option of using PKZIP 
  37. (tm) to automatically ZIP your trashed files in order to save even 
  38. more disk space. 
  39.  
  40. As a registered user you'll also get KeyDump, a TSR that does pretty 
  41. much what AutoDump does but at the touch of a key, even during other 
  42. programs.  That way if you're in the middle of another program and 
  43. you get a "Disk Full" message you can activate KeyDump and free up 
  44. some space.
  45.  
  46. In the interim you can use any file manager (like PC-Directory), or DOS 
  47. itself, to delete the files in the \TRASH subdir.  
  48.  
  49. *IMPORTANT*  Trash-It doesn't interfere with deletes done in the \TRASH 
  50. subdir.  Files deleted in the \TRASH subdir are actually deleted. 
  51.  
  52. Getting started:
  53.  
  54. Before you use Trash-It for the first time you need to create a 
  55. subdirectory called "\TRASH" on your hard disk by entering: 
  56.  
  57.    "md \trash" 
  58.  
  59. at the DOS prompt.  
  60.  
  61. If you have your hard drive partitioned than create a "\TRASH" subdir in 
  62. each partition. 
  63.  
  64. After you've created the "\TRASH" subdir then all you do to run Trash-It 
  65. is move to the subdir where TI.COM is located and enter "ti" at the DOS 
  66. prompt.  Once loaded Trash-It automatically intercepts all attempts via 
  67. DOS function calls to delete files, and instead moves the files to the 
  68. Trash ("\TRASH subdir").  You don't do anything different than before.  
  69. It is totally transparent to the user. 
  70.  
  71. NOTE:  The "how to register" information that appears when Trash-It is 
  72. loaded, and the 5 second delay, will disappear when you register. 
  73.  
  74. The best way to make sure Trash-It is loaded is to put "TI.COM" in the 
  75. root directory, and the phrase "TI" on a line by itself within your 
  76. "AUTOEXEC.BAT" file, also located in the root directory.  This will 
  77. automatically load Trash-It every time you boot your computer. 
  78.  
  79. You can remove Trash-It from memory by entering "ti/u" at the DOS prompt.  
  80. Remember, you always remove TSR's in the reverse order in which they were 
  81. loaded.  If you don't, it's possible your computer will lock up, 
  82. requiring a re-boot.  If you get the "unable to remove Trash-It" message 
  83. TI.COM probably wasn't the last TSR loaded. 
  84.  
  85. The Configuration Program:
  86.  
  87. Trash-It also comes with a configuration program.  The key to keeping 
  88. disk space free is to only trash significant files.  The configuration 
  89. program lets you do just that.  To run it, go to the where the Trash-It 
  90. files reside and enter "TI_CFG" at the DOS prompt.  Do it now. 
  91.  
  92. You use the configuration program to exempt files from being trashed.  
  93. You can set a minimum file size in which files greater than the limit 
  94. are trashed (moved to the TRASH subdir) and those less than the limit 
  95. are deleted.  This can save a lot of disk space.  Even a 1 byte file 
  96. can take up to 4K of hard disk space.  By having Trash-It delete small 
  97. files (instead of trashing them) you can free up a significant amount of 
  98. disk space, without sacrificing important files.  The number Trash-It 
  99. displays in the configuration program is the file size in bytes NOT 
  100. Kilobytes. 
  101.  
  102. The configuration program also lets you specify up to 10 different 
  103. filters.  All "deleted" files that match the filters you specify will be 
  104. deleted instead of trashed.  This too can save a significant amount of 
  105. disk space.  For example, some programs create temporary files with "TMP" 
  106. as the filename extension.  These files aren't important once the program 
  107. ends and are deleted. If you specify "*.TMP" in the configuration program 
  108. then Trash-It would delete these files rather than trash them.  You may 
  109. use the global character "?" when defining your extensions. 
  110.  
  111. The next to last item in the configuration program lets you decide 
  112. whether you want Trash-It to change the trashed file's date/time to the 
  113. time it was trashed.  If you select "No" then Trash-It leaves the 
  114. date/time of the trashed file unchanged.  This lets Trash-It run a little 
  115. faster.  The downside is that you have no way of knowing when the file 
  116. was trashed, rendering AutoDump and KeyDump practically useless.  "Yes" 
  117. is the default value and the position we recommend.  However if you're a 
  118. real speed freak, or for some reason you want the deleted files to retain 
  119. their original date/time, then select "No". 
  120.  
  121. The last item determines how Trash-It handles duplicate files in the 
  122. \TRASH.  If you select "Yes" (overwrite) then TI will overwrite the file 
  123. in the \TRASH with the new file being trashed.  If you select "No" (the 
  124. default) then TI will increment the last letter of the filename until it 
  125. can come up with a unique name.  For example, if you are deleting a file 
  126. called LETTER and a LETTER file already exists, overwrite would simply 
  127. delete the LETTER file in the trash and replace it with the one being 
  128. deleted, while "No" overwrite would give the newly deleted TEMP file the 
  129. name TEMQ.
  130.  
  131. Although overwriting will reduce the number of files kept in the \TRASH 
  132. it may also prevent important files from being saved.  For example, 
  133. several of my programs let you attach "filenotes" to the files in a 
  134. directory listing.  These filenotes are kept in a FILENOTE file within 
  135. each directory.  If you were to delete several of these, and you were in 
  136. overwrite mode, only the last FILENOTE deleted would be in the \TRASH, 
  137. and it might not be the one you want. 
  138.  
  139. To change an item in the configuration program use the up/down arrow keys 
  140. to select the item and press C for Change.  Then input the new value.  To 
  141. delete an extension: select the extension you want to delete, press C for 
  142. Change, and then press the Enter or Return key without entering anything.  
  143. When you've finished making all your changes then press the Escape key to 
  144. save the changes and exit the configuration program. 
  145.  
  146. Limitations:
  147.  
  148. Programs can delete files using two methods.  Most programs use DOS 
  149. function calls do it.  However, a few programs directly modify the 
  150. disk data (FAT and Directory info) without using DOS. 
  151.  
  152. *  Trash-It works only if DOS function calls are used to delete     *
  153. *  the file(s).                                                     *
  154.  
  155. Trash-It can't protect against programs that go in and modify the FAT 
  156. and Directory information directly.  However, almost all programs let 
  157. DOS do what it's designed for by using DOS function calls to delete 
  158. files, thereby allowing Trash-It to do its job.   
  159.  
  160. *  Trash-It only works if it finds a "\TRASH" subdirectory on the    * 
  161. *  disk (or partition) where the deleted files are located.          *
  162.  
  163. For example, let's say you have a Trash subdir on your hard drive, 
  164. C:.  You then attempt to delete files on the A: drive.  If the disk 
  165. in the A: drive doesn't have a \TRASH subdir then the files will be 
  166. deleted, even tho there is a \TRASH subdir on the C: drive.  Files 
  167. will only be moved to the \TRASH subdir if the \TRASH subdir is 
  168. located on the same disk as the files being deleted.  Of course, you 
  169. can make \TRASH subdirs on all your disks if you want.
  170.  
  171.                          ** WARNING ** 
  172.     You shouldn't take deleting files any less seriously than 
  173.     you always have, because in the situations described above 
  174.     (and possibly a few we don't know about yet) the file will 
  175.     actually be deleted. 
  176.  
  177. Using AutoDump:             Registered Users Only
  178.  
  179. AutoDump helps free up disk space by automatically deleting trashed 
  180. files older than the user-specified number of days, or smaller than 
  181. the user-specified size.  You adjust these values by configuring 
  182. AutoDump.  To configure AutoDump enter "autodump /c" at the DOS prompt 
  183. and follow the instructions.  You'll notice when you configure that 
  184. you also have the option of Zipping the trashed files. 
  185.  
  186. The Zip option uses PKZIP (a shareware file compression program from 
  187. PKWARE: 1-414-352-7176) to combine and compress all the files that 
  188. have been trashed since the last time you used AutoDump and puts them 
  189. in a single file.  The advantage is that this frees up disk space.  
  190. The disadvantage is that it's harder to know what files have been 
  191. trashed, making it tougher to find and recover a trashed file.  
  192. Personally, I wouldn't use this option unless disk space is at a 
  193. premium. 
  194.  
  195. The filename given the zipped file contains the month and day plus a 
  196. letter starting at A and increasing each time AutoDump is run on the 
  197. same date.  For example, if today is October 5th then the filename 
  198. would be 1005A.ZIP.  If you ran AutoDump again today then the 
  199. filename would be 1005B.ZIP, and so on.  Tomorrow the filename would 
  200. be 1006A.ZIP.
  201.  
  202. * AutoDump treats .ZIP files just like trashed files and will delete   *
  203. * them after they become older than the user-specified number of days. *
  204.  
  205. If you have .ZIP files in the TRASH subdirectory, they won't be added to 
  206. the .ZIP file Autodump creates.  In other words, only those files that 
  207. don't have .ZIP extensions will be compressed into .ZIP files.
  208.  
  209. In order for the Zip option to work, PKZIP.EXE must be in the directory 
  210. from which AutoDump is run, not necessarily where AutoDump resides.  For 
  211. example, let's say you keep the Trash-It files in a subdirectory called 
  212. "TI" and you want AutoDump to run every time you boot your computer so 
  213. you put the phrase "\TI\AUTODUMP" in your AUTOEXEC.BAT file.  Since the 
  214. AUTOEXEC.BAT file resides in the root directory then PKZIP.EXE must be in 
  215. the root directory as well, even though TI.COM isn't. 
  216.  
  217. Refer to the PKZIP documentation for instructions on how to view and 
  218. retrieve files in a .ZIP file. 
  219.  
  220. Give some thought to the values you chose for AutoDump.  If you're not 
  221. short of disk space then you'd want to specify a larger # of days to keep 
  222. trashed files around than you would if disk space is at a premium.  
  223. Remember too, that you can specify a minimum file size in Trash-It 
  224. itself, so why specify it again here?  The reason: tiny files usually 
  225. aren't important, and if they are you'll probably know right away.  By 
  226. making the minimum file size smaller in Trash-It than in AutoDump you 
  227. give yourself a period of time where you can recover these tiny files 
  228. before AutoDump comes along and deletes them.  You still get your hard 
  229. disk cleaned up, it's just that you now have a grace period to recover 
  230. those tiny little buggers. 
  231.  
  232. You run AutoDump by entering "autodump" at the DOS prompt.  The best 
  233. way to operate AutoDump is from your AUTOEXEC.BAT file.  That way 
  234. it's activated every time you boot your computer, without any input 
  235. from you at all.
  236.  
  237. Using KeyDump:              Registered Users Only
  238.  
  239. KeyDump enables those of you silly enough not to use PC-Directory, to 
  240. recover (maybe) from a "disk full" error.  It operates exactly the same 
  241. as AutoDump, except there's no .ZIP option, and you activate it by 
  242. pressing its hot key Ctrl-Alt-K.  By specifying a higher value for the 
  243. "min file size" variable, or a lower value for the "# of days to keep 
  244. trashed files" in KeyDump than in AutoDump, KeyDump will hopefully find 
  245. more trashed files to get rid of, thereby freeing up enough disk space 
  246. (we hope) for the current application to recover from the disk full 
  247. error.  You could even set the number of days to keep trashed files 
  248. around to zero, thereby deleting all the trashed files whenever you 
  249. activate KeyDump.  Drastic but effective. 
  250.  
  251. KeyDump is a small TSR (2K) which means you only run it once when you 
  252. first boot your computer and it stays hidden in memory waiting for you to 
  253. activate it.  You load KeyDump into memory by entering "keydump" at the 
  254. DOS prompt.  You configure it (change the file size, and # of days 
  255. values) by entering "keydump /c" at the DOS prompt and following the 
  256. instructions. 
  257.  
  258. After you've loaded KeyDump if you ever get a "disk full" message then 
  259. press Ctrl, Alt, and the K key at the same time.  KeyDump will do its 
  260. thing and emit a double beep to let you know it's done.  Then have the 
  261. current application try again to save the file. 
  262.  
  263. A much better method of recovering from a "disk full" message is to use a 
  264. TSR file manager like PC-Directory that lets you pop-up, go over and 
  265. selectively delete trashed files, and then return.  This way you can 
  266. delete as many trashed files as necessary: more or less as the need 
  267. requires.  
  268.  
  269. Of course if you use a multi-tasker like DesqView or Windows, you can 
  270. change to the DOS window, or a file manager window (like the non-TSR 
  271. version of PC-Directory), delete some trashed files, and then return to 
  272. the application that gave you the "disk full" message and try again. 
  273.  
  274. Remember, if you configure Trash-It to NOT change the trashed file's 
  275. date/time to the date/time when it was trashed then AutoDump and KeyDump 
  276. will delete trashed files according to when they were created or last 
  277. modified, not when they were trashed. 
  278.  
  279. Tech Support:
  280.  
  281. Registered users can call (206) 939-4105 for technical support.  You can 
  282. also contact us by E-Mail on Compuserve ID #: 72371,1557 
  283.  
  284. How Much?:
  285.  
  286. Trash-It (tm) is copyrighted 1990-92 by RSE Incorporated.  It's being 
  287. released as user-supported shareware.  This means you're given this copy 
  288. in order to evaluate it.  If after a 21 day evaluation period you decide 
  289. to continue using Trash-It, you need to become a registered user by 
  290. sending the registration fee of $15 plus $1 shipping (add $1 for 3.5 
  291. disk, $5 for overseas) to: 
  292.  
  293.  Trash-It Registration │  Mastercard or Visa customers: │ Modem-It! to: 
  294.  1157 57th Drive SE    │  Call or FAX (206) 939-4105    │ (206) 939-2312
  295.  Auburn, WA 98002      │  Compuserve: 72371,1557        │ Product ID: TI
  296.  
  297. A Manual containing printed documentation for all 12 of our shareware 
  298. products (including Trash-It) is available for an extra $5. 
  299.  
  300. You're encouraged to freely distribute copies of the TI20.EXE file as 
  301. long as you don't charge anything for the copies.  DO NOT distribute the 
  302. individual, extracted, files; only TI20.EXE. 
  303.  
  304. When you register Trash-It you'll receive a disk crammed full of our 
  305. other user-supported programs including PC-Directory, Playback, 
  306. Conjecture, Remind Me!, Nabbit, BriteLine, and PC-Images.  After all, 
  307. you'll need a good file manager to go with Trash-It, and PC-Directory is 
  308. the best (if I do say so myself...). 
  309.  
  310. Registered users also get the two programs described earlier: AutoDump 
  311. and KeyDump.  
  312.  
  313. In addition, when you register all the "please register" info that 
  314. appears when you run Trash-It (along with the 5 second delay), 
  315. disappears. 
  316.  
  317. Those using Trash-It in a commercial or educational environment must 
  318. register within 30 days.  Site licenses are available, as well as 
  319. quantity discounts. 
  320.  
  321. I hope you find Trash-It worthy of your support.  Take care. 
  322.  
  323. *** Disclaimer ***
  324.  
  325. RSE Incorporated specifically disclaims all warranties expressed or 
  326. implied, including, without limitation, any implied warranties of 
  327. merchantability or fitness for a particular purpose.  The software itself 
  328. is licensed "As Is", without any express or implied warranties 
  329. whatsoever.  In no event shall RSE Incorporated, its distributors or 
  330. dealers, be liable for any loss of profit or any other commercial damage, 
  331. including, without limitation, special, incidental, consequential or 
  332. other damages.  In no case shall any liability exceed the price paid for 
  333. the software. 
  334.  
  335.